.TH "nvme_identify_ctrl_list" 9 "nvme_identify_ctrl_list" "November 2025" "libnvme API manual" LINUX
.SH NAME
nvme_identify_ctrl_list \- Retrieves identify controller list
.SH SYNOPSIS
.B "int" nvme_identify_ctrl_list
.BI "(int fd "  ","
.BI "__u16 cntid "  ","
.BI "struct nvme_ctrl_list *cntlist "  ");"
.SH ARGUMENTS
.IP "fd" 12
File descriptor of nvme device
.IP "cntid" 12
Starting CNTLID to return in the list
.IP "cntlist" 12
User space destination address to transfer the data
.SH "DESCRIPTION"
Up to 2047 controller identifiers is returned containing a controller
identifier greater than or equal to the controller identifier  specified in
\fIcntid\fP.

See \fIstruct nvme_ctrl_list\fP for a definition of the structure returned.
.SH "RETURN"
The nvme command status if a response was received (see
\fIenum nvme_status_field\fP) or -1 with errno set otherwise.
